
Readme for Web Directory Script v2.0

------------------------------------------------------------------------
Overview
--------

Welcome to Web Directory Script!
Web Directory Script is a classifieds listings script, built in PHP.
The site owner could configure this script in any way he wants.
It will bring a lot of money to the site owner, without any spending.Web
Directory Script may be used for auto, business, employment, personals,
real estate and rentals listings.

--------
Features
--------

The script contains a whole list of features, which are necessary for
addition/edition/deletion members and their listings. View the summary of key
features below:

General:

- Search engines friendly URLs:
Urls of listings and categories are full search engine friendly.

- Free and Featured listings:
Free listings need to attract members and featured need to earn money.

- Unlimited Categories:
You can have unlimited categories and an unlimited category depth.

- Powerful Searching:
Search all listings by keywords, categories, locations or by zipcode.

- Multi-Lingual:
Contains transnational file and you can translate it into any language.


Administration:

- Can setup the advertisement period and payment:
You can setup the advertisement period in days and the payment for it.

- Currency Setup:
Wen Directory Script allows admin to setup currency symbol and currency code.

- User Management:
Manage all aspects of your users.

- Listing Management:
Manage all aspects of users' listings, also you can add and manage your own
listing.

- E-mail Notifications Management:
Manage e-mail notifications using variables.

- Transaction History:
You may see all transactions and bills made by users.

- Banner Advertisement:
The script allows to add and manage JPG or GIF image or Flash(SWF) banner.


Members Key Features:

- Once someone registers at your classifieds website they become a member and
are allowed to place listings. A member has the ability to modify their account,
place listings, modify listings, prolong listings.

- Prolong Listings Expiration Date:
After the paid period has expired members can easily prolong advertisement
period by creation new transaction.

- Make up Photo Gallery:
In featured listings members can make up photo gallery with thumbnails and full
size images.


Type of Listings:
- Featured:
  - Featured level listings appear in search results above Free listings;
  - Contains Detail View and Summary View;
  - Title, Logo Image, Address, Phone, Fax, Web Link, E-Mail Link, Summary
    Description, Detail Description, Photo Gallery.

- Free:
  - Title, Address, Phone, Web Link, E-mail Link.


-------------------
Server Requirements
-------------------
- PHP Version 4.1 or above
- MySQL 3.23 or above
- GD or GD2 for the image upload and resize functions.
- ModRewrite module


-----------
Directories
-----------

/sitemgr                        - administration scripts
/members                        - members scripts
/language                       - contains language transnational files
/index_files                    - css and js files
/images                         - layout images
/Guide                          - included listings images

Place all of the files and directories retaining their structure  onto your web
server.

/members/veiw_terms.php         - file with the terms of use of your service (need to edit)

-----
Setup
-----

1) Copy all files and folders to your server using ftp.


2) Create myslq database on the server.


3) Run 'install.php' file, this will install mysql tables ('DB.txt' must be in the
   root folder with index.php)


4) Appropriately modify the variables within the global.php file:

   $site_name - your site name
   $host - enter wull path to the directory folder
   $send_mail_path - sendmail path on your server

   $business_email - your paypal account email

   $DEFAULT_URL - url of your directory site (the same as $host)
   $DIRECTORY_TITLE - the name of your site (for e-mail notifications)

   $db_server - database server
   $db_user   - database username
   $db_pass   - database password
   $db_name   - database name

   In the 'configuration language file' section edit an existed transnational
   file, that must be in the '/language' folder. English by default ('en.php').


5) If the script isn't in the root folder on your server, you must edit .htaccess
   file and last 4 rules in such style:

   RewriteRule ^listings/([^/]+)$ {path}/category.php?cat=$1

   Where {path} - is the path from root to the script.


6) Use '/sitemgr/login.php' to setup your admin settings (default
   username/password: admin/admin).


7) Change access atributes on 777 for folders:  '/Guide/images',
   '/members/listings' and '/sitemgr/listings'.


-------------------------
Feedback and/or Questions
-------------------------

Feel free to e-mail us any feedback and/or questions that you may have to:

        admin@salephpscripts.com

Cheers,

Michael.